Summary

• Adds raise-pr skill that automates the full PR workflow (detect workspace, build, generate changeset, commit, push, create PR) for both rhdh-plugins and community-plugins monorepos
• Auto-detects which repo you're in via git remote -v and adapts PR template, npm scope, and upstream target accordingly
• Supports --a auto-approve mode to skip all approval gates for unattended workflows
• Built-in Jira integration — accepts a Jira key or URL, includes it in branch name and commit trailer, and performs post-PR Jira updates (Web Link, comment, transition to Review)
• Adds bug-fix skill for end-to-end bug fixing from Jira tickets with Playwright-based before/after screen recordings
• Bumps version to v0.7.0

Architecture

Context

Extracts and generalizes the existing Cursor command (rhdh-plugins/.cursor/commands/pr.md) and its #3679 enhancement into a portable agent skill that works across both plugin monorepos.

The raise-pr skill has first-class Jira support — any PR linked to a Jira issue gets automatic branch naming (fix/<workspace>-<JIRA-KEY>-<slug>), a Fixes: commit trailer, a ## Fixed section in the PR body, and post-PR Jira updates (Web Link + comment + transition to Review).

The bug-fix skill chains into raise-pr after reproducing and fixing a bug: it writes a Playwright reproduction test with video recording, diagnoses the root cause, applies the fix, captures before/after recordings, converts them to GIFs, and creates the PR with embedded visual evidence.

How to Use

Prerequisites

• Working checkout of rhdh-plugins (or community-plugins)
• yarn available on PATH
• ffmpeg on PATH (for converting screen recordings to GIFs). Install if missing: which ffmpeg || brew install ffmpeg
• Jira auth configured: .jira-token file next to acli binary, or Jira MCP in Cursor

Install

Install from local checkout (while PR is unmerged):

cd /path/to/rhdh-plugins
npx skills add /path/to/rhdh-skill --skill bug-fix
npx skills add /path/to/rhdh-skill --skill raise-pr

After merge:

npx skills add redhat-developer/rhdh-skill --skill bug-fix
npx skills add redhat-developer/rhdh-skill --skill raise-pr

Invoke

/bug-fix RHDHBUGS-1234
/bug-fix https://redhat.atlassian.net/browse/RHDHBUGS-1234

What it does

1. Fetches the Jira issue (summary, description, steps to reproduce, component)
2. Maps the Jira component to a workspace (e.g., "Lightspeed" → workspaces/lightspeed)
3. Discovers e2e infrastructure (Playwright config, helpers, translations)
4. Writes a temporary reproduction test with video recording enabled
5. Runs the test — expects it to fail (bug reproduced), captures "before" video
6. Diagnoses root cause and applies the fix
7. Re-runs the test — expects it to pass (fix verified), captures "after" video
8. Converts .webm recordings to GIFs via ffmpeg
9. Deletes the reproduction test (not included in the PR)
10. Chains into raise-pr — builds, generates changeset, commits, pushes, creates PR with before/after GIFs embedded, then adds Web Link + comment on the Jira issue and transitions it to Review

Using raise-pr standalone with Jira

raise-pr RHDHBUGS-1234
raise-pr https://redhat.atlassian.net/browse/RHIDP-15252

When a Jira key is provided, raise-pr automatically:

• Names the branch as fix/<workspace>-<JIRA-KEY>-<slug>
• Adds a Fixes: trailer in the commit message
• Includes a ## Fixed section in the PR body with the Jira link
• After PR creation: adds a Web Link on the Jira issue, posts a comment, and transitions the issue to Review

Files

raise-pr skill

• New: skills/raise-pr/SKILL.md — 11-step workflow with repo auto-detection, --a auto-approve mode, Jira context resolution, and post-PR Jira updates
• New: skills/raise-pr/references/repo-profiles.md — per-repo config (upstream remote, npm scope, PR body template with conditional Jira/recording sections)
• New: skills/raise-pr/references/jira-input.md — shared Jira key/URL parsing logic and REST API patterns (auth, remote links, transitions)

bug-fix skill

• New: skills/bug-fix/SKILL.md — 8-step workflow (fetch Jira issue, identify workspace, reproduce with video, diagnose, fix, verify, convert videos, chain into raise-pr)
• New: skills/bug-fix/references/workspace-map.md — Jira component to rhdh-plugins workspace directory mapping with runtime discovery instructions
• New: skills/bug-fix/references/e2e-patterns.md — shared Playwright patterns across all workspaces (multi-locale, dual-mode, translation helpers, MUI patterns, repro test template)
• New: skills/bug-fix/references/video-recording.md — Playwright video config, ffmpeg conversion, and GitHub PR embedding workflow

Metadata

• Modified: README.md — added Bug Fix section, updated raise-pr description with Jira integration mention
• Modified: pyproject.toml, .claude-plugin/plugin.json, .claude-plugin/marketplace.json — version bump to 0.7.0

Test plan

• uv run pytest passes (321 passed, 1 pre-existing failure unrelated to this PR)
• Skill structure tests pass (test_skill_structure.py)
• Marketplace/version tests pass (test_marketplace.py)
• Install via npx skills add redhat-developer/rhdh-skill --skill raise-pr and verify Jira input parsing
• Install via npx skills add redhat-developer/rhdh-skill --skill bug-fix and verify trigger phrases
• Test raise-pr with a Jira key: verify branch name, commit trailer, PR body, and post-PR Jira updates
• Test bug-fix with an RHDHBUGS issue: verify full workflow from reproduction to PR creation